home *** CD-ROM | disk | FTP | other *** search
/ Wildcat Gold - The Optical BBS / Wildcat Gold - The Optical BBS (The Golden ROM Series)(Volume 4 Number 1)(The Digital Publishing Company)(1992).ISO / sdn / wf200_c.sdn / WF.013 < prev    next >
Text File  |  1989-12-22  |  11KB  |  250 lines
  1. .f3                              - # -              Chapter 13 - Macros
  2. .rm70
  3. .mt5
  4. .mb5
  5. .pl66
  6. .tc
  7. .tc 13. MACROS ............................................#
  8. 13. MACROS
  9.  
  10. A macro is essentially a pre recorded sequence of key strokes that you
  11. wish to execute. Each macro may contain up to 255 characters, and is
  12. stored in a macro file. Several macro files are provided with the Word
  13. Fugue package. They all end with the extension .MAC  The standard one
  14. WF.MAC will always be loaded on startup.
  15.  
  16. The files provided are:-
  17.  
  18. WF.MAC     standard macros for word processing
  19.  
  20. SINGLE.MAC definitions for box drawing characters, concentrating on
  21.            single lines.
  22.  
  23. DOUBLE.MAC definitions for box drawing characters, concentrating on
  24.            double lines.
  25.  
  26. GREEK.MAC  allows access to the Greek character set (as supported by
  27.            the IBM PC)
  28.  
  29. EUROPE.MAC allows access to the European characters supported by the
  30.            IBM PC.
  31.  
  32. PASCAL.MAC assorted macros for pascal programmers.
  33.  
  34. Each macro has an identifying character that is used to activate it or
  35. replay it. These identifiers are the numbers 0 to 9, and the letters A
  36. to Z. Lowercase and uppercase letters are treated the same. You can
  37. only load one macro file at a time, but you can use macros to load
  38. other macro files and execute macros from there. In addition you can
  39. load a different macro file to execute a single command, and the
  40. return to your original macro file.
  41.  
  42. You can have a set of macro files in each directory you use if
  43. necessary, since Word Fugue looks in the current directory when
  44. loading a macro file. When first started, Word Fugue will look for the
  45. macro file WF.MAC in the default directory and if it does not find it
  46. there, will look in the defined home directory.
  47.  
  48. .tc    Recording A Macro ..................................#
  49. Recording A Macro
  50.  
  51. Before you can use macros, you need to set them up. The simplest
  52. method is to record a sequence of key strokes. You achieve this by
  53. pressing Alt R at the start of the sequence, and Alt R again when you
  54. have finished. You will be prompted with a list of macros in the macro
  55. file, and you will be asked to choose one to use as the repository of
  56. the characters you have just recorded. Use the cursor movement keys to
  57. highlight the macro you wish to store the keystrokes in, and press
  58. Return. You will then be prompted for a name for the macro, which is
  59. displayed whenever a list of available macros is displayed. Enter
  60. something meaningful, and if possible, prefix it with the letter that
  61. will be used to activate it.
  62.  
  63. You need to be sure that the sequence of keystrokes you enter is
  64. correct, since they will be replayed exactly as you entered them.
  65. However, if necessary, you can edit the stored macro command to
  66. correct it.
  67.  
  68. .tc    Editing A Macro ....................................#
  69. Editing A Macro
  70.  
  71. Macros recorded within WordFugue can be edited on a character by
  72. character basis using the built-in macro editor. Enter the command Alt
  73. E to edit a macro from the current set of loaded macros. A list of the
  74. current macros will be displayed, and you select the one you want by
  75. use of the cursor keys to highlight the appropriate one, and pressing
  76. Return to select it.
  77.  
  78. First, a prompt box will ask for a new name for the macro, which you
  79. can accept as is, or change. You should always include the activation
  80. letter in the name, for ease when replaying. The macros numbered 1 to
  81. 9 are activated by the numbers 1 to 9, while those numbered 10 to 35
  82. are activated by pressing the letters A to Z in that order.
  83.  
  84. The macro will appear in another window. It can be edited using the
  85. cursor keys, and the <Del> or <Backspace> keys. Most characters you
  86. type will be inserted literally into the macro. <CtrlBksp> will delete
  87. the macro. <Enter> will end the session in the macro editor. <Esc>
  88. will undo any changes made to the macro. In case you need to enter any
  89. of these special keys as part of the macro, press the <ScrollLock> key
  90. to enter Literal mode. In this mode, all keystrokes will be inserted
  91. into the macro without any interpretation. In order to terminate the
  92. edit when in this mode, you will need to press <ScrollLock> again in
  93. order to enter the Return or ESC characters.
  94.  
  95. .tc    Saving A Macro File ................................#
  96. Saving A Macro File
  97.  
  98. If the macro you have recorded are to be of any use in later sessions
  99. of Word Fugue, you will need to save the file containing them. The
  100. command sequence Alt W will save the macro file. You will be prompted
  101. to enter a file name, with the current file name being displayed. You
  102. can either edit it, or press Return to accept it.
  103.  
  104. If the filename already exists, you will be prompted with Overwrite
  105. File? (Y/N) . If you enter Y the file will be overwritten. If you
  106. press N or ESC, the file will not be overwritten. In this situation
  107. you will need to enter the command again and type in a different file
  108. name.
  109.  
  110. .tc    Playing Back A Macro ...............................#
  111. Back A Macro
  112.  
  113. Having set up a macro, you can now play it back. There are several
  114. commands available to do this.
  115.  
  116. .tc       Activate Macro 1 to 9 ...........................#
  117.   Activate Macro 1 to 9
  118.  
  119.   These macros can be activated by pressing Alt1 to Alt9 using the
  120.   numbers on the main keyboard above the letters. (Not the numeric key
  121.   pad - they will not work!!). You should place you most often used
  122.   macros in slots 1 to 9, since they are the easiest to activate.
  123.  
  124. .tc       Activate Macro ..................................#
  125.   Activate Macro
  126.  
  127.   This command waits for the next keystroke, and if it is a macro
  128.   identifier, activates that macro. Press Alt M or ESC (wordstar
  129.   compatible command). The top line will display choose macro to
  130.   apply. If you enter 0 to 9 or A to Z, the appropriate macro will be
  131.   activated. Press any other key to abort playback.
  132.  
  133.   This command assumes that you know which macros you have available,
  134.   and will not display any list. The macro will be replayed once.
  135.  
  136. .tc       Choose Macro From List ..........................#
  137.   Choose Macro From List
  138.  
  139.   This command displays a list of available macros for you to choose
  140.   from. Press Alt 0 to activate this command. You select the macro you
  141.   want by use of the cursor control keys to highlight the one you
  142.   want, and press Return to select it.
  143.  
  144.   The menu will disappear, and the macro will be replayed once. If you
  145.   change your mind, press ESC to abort the command.
  146.  
  147. .tc       Replay Macro Many Times .........................#
  148.   Replay Macro Many Times
  149.  
  150.   Press Alt - to activate this command. This command displays a list
  151.   of available macros for you to choose from. You select the macro you
  152.   want by use of the cursor control keys to highlight the one you
  153.   want, and press Return to select it.
  154.  
  155.   The menu will disappear, and you will be prompted for the number of
  156.   times to replay the macro. If you change your mind, press ESC to
  157.   abort the command. You will be told how many times the macro can fit
  158.   in the replay buffer. Enter a number and press Return. The macro
  159.   will replay the number of times you entered. This is especially
  160.   useful with the line drawing macros.
  161.  
  162. .tc       Find And Apply Macro ............................#
  163.   Find And Apply Macro
  164.  
  165.   This function allows you to apply a macro to text that the Find /
  166.   Replace command highlights. Press Ctrl Q M and a pop up search
  167.   window will display. Enter the text to be searched for. You will
  168.   then be prompted for the macro to replay. A list of available macros
  169.   for you to choose from will be displayed. You select the macro you
  170.   want by use of the cursor control keys to highlight the one you
  171.   want, and press Return to select it.
  172.  
  173.   You then enter the search / replace options. Refer to the chapter on
  174.   Find/Replace for more information on these.
  175.  
  176.   The cursor will be positioned at the end of the found text, and you
  177.   will be prompted whether to apply the macro or not (unless you
  178.   specified the N option for Do Not Ask). If you select Y then the
  179.   macro you selected will be applied to the text.
  180.  
  181. .CP10
  182. .tc       Example Macros ..................................#
  183.   Example Macros
  184.  
  185.   1   Delete Word Left:         <CtrlLft><CtrlT>
  186.  
  187.   4   Spell check this word:    <CtrlK><CtrlT><AltS>
  188.  
  189.   D   Date dd month yyyy:       <CtrlJ><CtrlI>@@D8<Enter>
  190.  
  191.   H   HRHighness:               Her Royal Highness Queen Elizabeth II
  192.  
  193.   X   Datestamp file at EOF:    <CtrlK>0
  194.                                 <CtrlPgDn>..Changed <CtrlJ>
  195.                                 <CtrlI>@D6<Enter>
  196.                                 <CtrlJ><CtrlI>@T0<Enter>
  197.                                 <Enter>
  198.                                 <CtrlQ>0<CtrlK>0
  199.  
  200.                                 Set marker 0
  201.                                 Go to bottom of file and insert text
  202.                                 ..Changed followed by a blank
  203.                                 Insert date
  204.                                 Insert time
  205.                                 Terminate line with CR
  206.                                 Return to marker 0
  207.                                 Switch off marker 0
  208.  
  209. .tc    Loading A Macro File ...............................#
  210. Loading A Macro File
  211.  
  212. There are 2 methods of loading a Macro file, the first to load a file
  213. for usage, and the second to load a file to replay only one macro and
  214. then to re-load the original macro file. This second command is very
  215. useful for extending the number of macros available by placing less
  216. frequently used ones on a separate file.
  217.  
  218. .tc       Load A Macro File ...............................#
  219.   Load A Macro File
  220.  
  221.   Pressing the command Alt L will prompt you for a file name to load
  222.   as a macro file. The default extension for a macro file is .MAC. You
  223.   may use wild cards to search the directory. If you press ESC you can
  224.   abort the load process, and the currently loaded file remains
  225.   loaded.
  226.  
  227.   Otherwise the new macro file will be loaded for use. You can have
  228.   different macro files for different tasks, such as the line drawing
  229.   macro files supplied with Word Fugue and the Pascal macros also
  230.   supplied.
  231.  
  232.   Once a macro file is loaded using this command, it remains loaded
  233.   until you load another file.
  234.  
  235. .tc       Temporarily Load A New Macro File ...............#
  236.   Temporarily Load A New Macro File
  237.  
  238.   This command loads a new macro file to enable you to execute one
  239.   command from the file. The old macro file is then reloaded. Press
  240.   Ctrl J I M  and you will be prompted for the name of the macro file
  241.   to load. You will then be presented with the list of available
  242.   macros for you to select one to replay. You select the macro you
  243.   want by use of the cursor control keys to highlight the one you
  244.   want, and press Return to select it.
  245.  
  246.   The macro will be replayed once, and then the original macro file
  247.   will be reloaded. If you change your mind, you can press ESC at any
  248.   stage, and the process will abort and the original macro file will
  249.   reload.
  250.